Complete TypeScript toolkit for creating Microsoft Agent (MSAgent) character definitions - the animated desktop assistants like Clippy, Merlin, etc.

Core Components

• CharacterBuilder - Fluent API for character creation with animations, sounds, balloon config
• AnimationBuilder - Frame sequence builder with branching, sounds, timing controls
• CharacterExporter - JSON export/import, package export, validation
• CLI - Interactive character creation workflow

Usage

import { CharacterBuilder, AnimationBuilder, createStandardAnimation } from 'msagent-ai';

const builder = new CharacterBuilder({
  name: 'MyAgent',
  width: 128,
  height: 128,
  includeStandardAnimations: true
});

const wave = new AnimationBuilder('CustomWave')
  .setLoop(false)
  .createFrame('base64data', 100)
  .build();

builder.addAnimation(wave);
builder.setBalloonConfig({ fontName: 'Comic Sans MS', fontSize: 14 });

CharacterExporter.exportToJSON(builder.build(), 'agent.json');

Standard Animations

33 built-in templates: Idle1-3, Show, Hide, Speak, Wave, Think, Pleased, Sad, gestures, etc.

Test Coverage

77 tests covering builders, utilities, and export functionality.

CI/CD

GitHub Actions workflow included for automatic builds:

• Runs on push/PR to main/master branches
• Tests on Node.js 18.x, 20.x, and 22.x
• Standalone executables built for Windows (.exe), Linux, and macOS
• Downloadable artifacts:
  • msagent-windows-x64 - Windows executable
  • msagent-linux-x64 - Linux executable
  • msagent-macos-x64 - macOS executable
  • msagent-all-platforms - All executables in one archive
• 30-day artifact retention

Building Executables Locally

npm run build:exe

This creates standalone executables in the bin/ directory that can run without Node.js installed.

💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.